home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / util / conv / Raw2Ent19.readme < prev    next >
Text File  |  1998-02-07  |  8KB  |  183 lines
  1. Short:    Entity-Codes, Alternatives, Color-Codes
  2. Author:   honma@uni-duesseldorf.de (Tamio Patrick Honma)
  3. Uploader: honma@uni-duesseldorf.de (Tamio Patrick Honma)
  4. Version:  1.9
  5. Type:     util/conv
  6. Replaces: util/conv/Raw2Ent*
  7.  
  8.  
  9. Hello again!
  10.  
  11. This release is the first after one whole year!  I didn't recognize that the
  12. time passed that fast! Well - here is the new version ...
  13.  
  14. This  program  is  usefull  for  HTML-Developers  and  can  also be used for
  15. Internet-,  Compuserve-, FIDO-, ZCONNECT-Newsgroups and eMails.  It supports
  16. the ability to convert 8Bit-characters into 7Bit-characters and reverse with
  17. the  help  of  character-entity-codes  or  -names or alternative characters.
  18. Additionaly   it   can  convert  HTML  3.2-  and  Netscape-color-names  into
  19. color-codes and reverse.
  20.  
  21. This program is written in 100% assembly language for the Motorola MC68000.
  22. It runs on every AmigaOS 2.0 and higher.
  23.  
  24. A GUI is not implemented at this moment, but an ARrexx-Script adds this
  25. program into Cygnus ED's Interface.
  26.  
  27.  
  28.  
  29. Files: Raw2Ent               1.9   (18.01.98)
  30.        Raw2Ent.ced           1.01  (26.12.96)
  31.        Raw2Ent.doc           english documentation
  32.        Raw2Ent.dok           german documentation
  33.        Raw2Ent.rexx          1.4.1 (14.07.96)
  34.        Raw2Ent.rexx.old      1.3.4 (01.11.96)
  35.        Raw2EntCheck          1.0   (12.12.96)
  36.        Raw2EntHTMLColors.iff HTML 3.2-Color-Names, -Codes and -Colors
  37.        Raw2EntLogic.asc      logical-structure documentation
  38.        Raw2EntMeta.asc       meta-structure documentation
  39.        Raw2EntTables.doc     code-tables documentation
  40.        Raw2EntUml.r2e        the Umlaut-table as a template for you
  41.  
  42.  
  43.  
  44. WHAT'S NEW SINCE LAST RELEASE?
  45.     - DATA-Mode allows you to define your own convertion-table
  46.     - standard-output feature included. Now it's possible to
  47.         a) preview the output in the console
  48.         b) append the source to destination (with ">>" (see AmigaDOS))
  49.         c) dircetly print the output etc. (with ">prt:" ("))
  50.  
  51.  
  52. FAST INTRODUCTION: (see below for a larger introduction)
  53. Raw2Ent can convert
  54.  
  55. 8Bit-ASCII (ISO-8859-1 [Amiga]) -> 7Bit-ASCII with Character-Entity-Codes
  56. example:            "Hallöchen" -> "Hallöchen"
  57.  
  58.    7Bit-ASCII with Entity-Codes -> 8Bit-ASCII (ISO-8859-1 [Amiga])
  59. example:         Hallöchen -> Hallöchen
  60.  
  61. 8Bit-ASCII (ISO-8859-1 [Amiga]) -> 7Bit-ASCII with alternative characters
  62. example:            "Hallöchen" -> "Halloechen"
  63.  
  64. HTML32- or NETSCAPE-COLOR-NAMES -> HTML-Color-Codes
  65. example:          BGCOLOR="Red" -> BGCOLOR="#FF0000"
  66.  
  67.                HTML-Color-Codes -> HTML32- or NETSCAPE-COLOR-NAMES
  68. example:      BGCOLOR="#FF0000" -> BGCOLOR="Red"
  69.  
  70.  
  71.  
  72. INTRODUCTION
  73.  
  74. Raw2Ent   converts   raw   8-Bit-ASCII-Text   into   7-Bit-ASCII-Text   with
  75. entity-codes  and  reverse.   The  ASCII-Format is a standardized format for
  76. information  interchange,  but it is only standardized seven-bit-wide, which
  77. means  that  128 codes are defined.  One Byte consists of eight bits and can
  78. represent  256  different  bit  combinations.   Therefore  the  last 128 bit
  79. combinations  are defined for free use by any operation-system.  The problem
  80. is that accent-characters and other special characters are not standardized,
  81. because  they  are defined in (guess where?!  ;) ) the free part of ASCII by
  82. the operation system developers.
  83.  
  84. The  goal of the Wold Wide Web developers was that it could be used on every
  85. important   operation   system.   So  it  was  clear  that  the  ASCII-Based
  86. HTML-Source-Code   had  to  use  the  standardized  seven-bit  area  of  the
  87. ASCII-Code.  To represent accent-characters or other special characters in a
  88. seven-bit-code,  it  was  neccesary  to  invent something.  And this was the
  89. entity-code  -  a  kind  of  escape-code.   An  entity-code  consists  of an
  90. introducing  "&"  and  a  ";"  at  the  end.   Between  these  symbols  is a
  91. character-name the browser can interpret.  It is a very hard and stupid work
  92. to convert the ASCII-Text by hand.  So just use Raw2Ent!
  93.  
  94. Raw2Ent  produces  real 7-Bit-ASCII-Code.  All printable Amiga-characters in
  95. the  8-bit-area  will be converted into entity-codes, without any exception.
  96. The  use  of names instead of code-numbers will make the entity-codes easier
  97. to be read by humans.  If no name was defined in the HTML 3.2 reference, the
  98. code-number will be used.
  99.  
  100. You  can use Raw2Ent also to check, wether your file contains pure seven-bit
  101. codes  or  not.   If  not,  Raw2Ent  will  present  you  the position of the
  102. 8-Bit-Characters in the text.
  103.  
  104. Raw2Ent can also handle color-codes and -names.
  105.  
  106.  
  107.  
  108.                              //             \\
  109.                            \X/ Amiga ForEVER \X/
  110.  
  111. GRÜSSE !!!
  112.  
  113. Ich grüße alle verbliebenen Amiga-Benutzer!
  114.  
  115. Ich   bin  davon  überzeugt,  daß  Amiga  mehr  und  mehr  an  Bedeutung  im
  116. Computersektor  gewinnen  wird.  Wir können doch nicht zulassen, daß wir als
  117. MultiMedia-Pioniere  den  ewigen  Nachzüglern das Feld freilassen!  Der Witz
  118. ist  ja,  daß  viele  Features des Amigas immer noch nicht von PC's erreicht
  119. wurden.   PC's  konnten ja nur deshalb in den Multimedia-Bereich vordringen,
  120. weil  die  DOSen  mit  immer  mehr  Power  vollgestopft wurden und nicht mit
  121. innovativen Technologien und Konzepten.  Amigas sind nach wie vor die einzig
  122. wahren  Multimedia-Rechner.  Und die fehlende Power wird Amiga International
  123. hoffentlich  bald  beseitigen  und  vielleicht noch mehr innovative Konzepte
  124. realisieren.
  125.  
  126.                              //             \\
  127.                            \X/ Amiga ForEVER \X/
  128.  
  129.  
  130.  
  131. SEND COMMENTS TO:
  132.  
  133. Tamio Patrick Honma
  134.  
  135. eMail: honma@uni-duesseldorf.de
  136.   WWW: http://www-public.rz.uni-duesseldorf.de/~honma/
  137.  
  138.                       *>> Love all over the world! <<*
  139.  
  140.  
  141.  
  142.  
  143. ----------------------------------------------------------------------------
  144.                                POST SCRIPTUM
  145. ----------------------------------------------------------------------------
  146.  
  147. Dieses  Projekt  wurde  von  einem  Studenten  der  Informationswissenschaft
  148. entwickelt.   Informationswissenschaft  ist nicht so bekannt wie Informatik,
  149. doch   die  Qualifikationen  sind  weitreichend  und  gehen  weit  über  die
  150. Beherrschung  der  Maschine  hinaus.   Informationswissenschaftler  erhalten
  151. Qualifikationen,    die    vor    allem    in    der    sich   abzeichnenden
  152. "Informationsgesellschaft"   immer   mehr   an   Bedeutung  gewinnen.   Alle
  153. Informationsprozeße  -  beispielsweise  im  Informationsmanagement  - werden
  154. analytisch durchleuchtet und Lösungen zu Problemen praktisch realisiert.
  155.  
  156. Dieses Post-Skriptum sollte ein wenig Licht ins Dunkel bringen, da viele mit
  157. diesem Begriff der "Informationswissenschaft" nichts anfangen können.
  158.  
  159. Das  WWW-Angebot der Informationswissenschaft der Heinrich-Heine-Universität
  160. Düsseldorf findest Du unter:
  161.  
  162. http://www.phil-fak.uni-duesseldorf.de/infowiss/
  163.  
  164.  
  165. ============================= Archive contents =============================
  166.  
  167. Original  Packed Ratio    Date     Time    Name
  168. -------- ------- ----- --------- --------  -------------
  169.    11076    5593 49.5% 19-Jan-98 02:13:04  Raw2Ent
  170.     1192     637 46.5% 26-Dec-96 15:55:28  Raw2Ent.ced
  171.    24604    8813 64.1% 19-Jan-98 22:17:24  Raw2Ent.doc
  172.    26821    9786 63.5% 19-Jan-98 22:17:12  Raw2Ent.dok
  173.     1131     580 48.7% 17-Nov-96 23:07:06  Raw2Ent.rexx
  174.     5120    1482 71.0% 17-Nov-96 23:07:06  Raw2Ent.rexx.old
  175.      465     287 38.2% 12-Dec-96 13:11:32  Raw2EntCheck
  176.    14604    2587 82.2% 27-Dec-96 03:24:00  Raw2EntHTMLColors.iff
  177.     1489     335 77.5% 18-Jan-98 06:14:36  Raw2EntLogic.asc
  178.     4866    2201 54.7% 27-Dec-96 14:21:32  Raw2EntTables.doc
  179.      487     388 20.3% 18-Jan-98 06:10:22  Raw2EntUml.r2e
  180.     1227     255 79.2% 13-Dec-96 00:07:34  Raw2EntMeta.asc
  181. -------- ------- ----- --------- --------
  182.    93082   32944 64.6% 23-Jan-98 06:42:30   12 files
  183.